Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Automate Superchain Registry chain support #8105

Open
wants to merge 60 commits into
base: master
Choose a base branch
from

Conversation

emlautarom1
Copy link
Contributor

Solves #8065

Changes

Types of changes

What types of changes does your code introduce?

  • Bugfix (a non-breaking change that fixes an issue)
  • New feature (a non-breaking change that adds functionality)
  • Breaking change (a change that causes existing functionality not to work as expected)
  • Optimization
  • Refactoring
  • Documentation update
  • Build-related changes
  • Other: Description

Testing

Requires testing

  • Yes
  • No

If yes, did you write tests?

  • Yes
  • No

Notes on testing

Added tests to verify that we're properly decompressing generated ChainSpec files. Some tests were updated to use a new ChainSpecFileLoader that is format-aware of ChainSpec files, thus is able to decompress them if needed.

Documentation

Requires documentation update

  • Yes
  • No

Requires explanation in Release Notes

  • Yes
  • No

Once this feature is properly working we need to document that Nethermind now supports all OP Superchain chains, not only a small subset (currently: OP, Base and Worldchain).

Remarks

The generated ChainSpec files are stored in a compressed format due to their excessive size when in .json format. Just like in the Superchain Registry repository (https://github.com/ethereum-optimism/superchain-registry/blob/cb9a0ca8eda1608bf9958137a736fd2c18884fbd/superchain/README.md) we use zstandard as the compression algorithm. This is due to the OP team already figuring out that this is one of the best algorithms for this use case, and also to reduce the required amount of code (our scripts already deal with decompression so might as well compress the resulting artifacts using the same algorithm).

Currently, 45 configs are generated: 28 in Mainnet and 17 in Sepolia.

We're still missing a GitHub action that automatically runs this script either periodically or when the Superchain Registry repository gets updated (the latter being preferable)

@kamilchodola
Copy link
Contributor

@stdevMac Can you take care of checking this and making sure it works accordingly with Sedge? Also add to our CI BUT limit those side chains to trigger once per week.

@emlautarom1
Copy link
Contributor Author

@kamilchodola @stdevMac Do not test this branch yet since it's not working ATM. I'll change the status to "ready to review" once I figure out what is the issue (currently Nethermind can't find peers).

Copy link
Contributor

@deffrian deffrian left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, but I have few questions:

  1. What will happen if they change format again?
  2. Can we put all op stuff in separate folder? Something like Cains/superchain and configs/superchain
  3. We need to check op-mainnet genesis is working.

src/Nethermind/Nethermind.Runner/configs/op-mainnet.json Outdated Show resolved Hide resolved
@emlautarom1
Copy link
Contributor Author

emlautarom1 commented Feb 6, 2025

  1. What will happen if they change format again?

If they change from zstd to something different then the script will break. This is the same in case they change directory structure, certain index files, etc.

Particularly, if they change the compression format we can either continue using zstd (we'll have to adjust the scripts to decompress the new format) or adopt the new format altogether. The later is not that complicated since this PR also introduces flexibility to extend Nethermind to load other Chainspec formats. We'll see what to do when it happens.

  1. Can we put all op stuff in separate folder? Something like Cains/superchain and configs/superchain

We could but we need to revisit all scripts that use the root directory (ex. syncSettings.py) and we make the initialization code a bit trickier with not a lot off benefit IMO. For now I suggest leaving it as is.

  1. We need to check op-mainnet genesis is working.

Currently on it. We should be able to merge once we can ensure that it works as expected.

@emlautarom1 emlautarom1 requested a review from rubo February 7, 2025 15:21

on:
schedule:
- cron: '0 0 * * 0'
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The workflow will run weekly. Does this sound OK @kamilchodola ?

}

using var decompressedStream = new DecompressionStream(streamData);
decompressedStream.LoadDictionary(buffer.ToArray());
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok but you first load it to MemoryStream and then ToArray, can you just use one data in the first place?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants